home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / kibitz.1 < prev    next >
Encoding:
Text File  |  1995-07-26  |  11.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11119999 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           kibitz - allow two people to interact with one shell
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           kkkkiiiibbbbiiiittttzzzz [ _a_r_g_s ] _u_s_e_r [ _p_r_o_g_r_a_m _a_r_g_s... ]
  13.           kkkkiiiibbbbiiiittttzzzz [ _a_r_g_s ] _u_s_e_r@_h_o_s_t [ _p_r_o_g_r_a_m _a_r_g_s... ]
  14.  
  15.      IIIINNNNTTTTRRRROOOODDDDUUUUCCCCTTTTIIIIOOOONNNN
  16.           kkkkiiiibbbbiiiittttzzzz allows two (or more) people to interact with one
  17.           shell (or any arbitrary program).  Uses include:
  18.  
  19.                o+   A novice user can ask an expert user for help.
  20.                    Using kkkkiiiibbbbiiiittttzzzz, the expert can see what the user is
  21.                    doing, and offer advice or show how to do it right.
  22.  
  23.                o+   By running kkkkiiiibbbbiiiittttzzzz and then starting a full-screen
  24.                    editor, people may carry out a conversation,
  25.                    retaining the ability to scroll backwards, save the
  26.                    entire conversation, or even edit it while in
  27.                    progress.
  28.  
  29.                o+   People can team up on games, document editing, or
  30.                    other cooperative tasks where each person has
  31.                    strengths and weaknesses that complement one
  32.                    another.
  33.  
  34.      UUUUSSSSAAAAGGGGEEEE
  35.           To start kkkkiiiibbbbiiiittttzzzz, user1 runs kibitz with the argument of the
  36.           user to kibitz.  For example:
  37.  
  38.                kibitz user2
  39.  
  40.           kkkkiiiibbbbiiiittttzzzz starts a new shell (or another program, if given on
  41.           the command line), while prompting user2 to run kkkkiiiibbbbiiiittttzzzz.  If
  42.           user2 runs kkkkiiiibbbbiiiittttzzzz as directed, the keystrokes of both users
  43.           become the input of the shell.  Similarly, both users
  44.           receive the output from the shell.
  45.  
  46.           To terminate kkkkiiiibbbbiiiittttzzzz it suffices to terminate the shell
  47.           itself.  For example, if either user types ^D (and the shell
  48.           accepts this to be EOF), the shell terminates followed by
  49.           kkkkiiiibbbbiiiittttzzzz.
  50.  
  51.           Normally, all characters are passed uninterpreted.  However,
  52.           if the escape character (described when kkkkiiiibbbbiiiittttzzzz starts) is
  53.           issued, the user may talk directly to the kkkkiiiibbbbiiiittttzzzz
  54.           interpreter.  Any EEEExxxxppppeeeecccctttt(1) or TTTTccccllll(3) commands may be given.
  55.           Also, job control may be used while in the interpreter, to,
  56.           for example, suspend or restart kkkkiiiibbbbiiiittttzzzz.
  57.  
  58.           Various processes can provide various effects.  For example,
  59.           you can emulate a two-way write(1) session with the command:
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11119999 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.                kibitz user2 sleep 1000000
  75.  
  76.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  77.           kkkkiiiibbbbiiiittttzzzz takes arguments, these should also be separated by
  78.           whitespace.
  79.  
  80.           The ----nnnnoooopppprrrroooocccc flag runs kkkkiiiibbbbiiiittttzzzz with no process underneath.
  81.           Characters are passed to the other kkkkiiiibbbbiiiittttzzzz.  This is
  82.           particularly useful for connecting multiple interactive
  83.           processes together.  In this mode, characters are not echoed
  84.           back to the typist.
  85.  
  86.           ----nnnnooooeeeessssccccaaaappppeeee disables the escape character.
  87.  
  88.           ----eeeessssccccaaaappppeeee _c_h_a_r sets the escape character.  The default escape
  89.           character is ^].
  90.  
  91.           ----ssssiiiilllleeeennnntttt turns off informational messages describing what
  92.           kibitz is doing to initiate a connection.
  93.  
  94.           ----ttttttttyyyy _t_t_y_n_a_m_e defines the tty to which the invitation should
  95.           be sent.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/23/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11119999 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.      MMMMOOOORRRREEEE TTTTHHHHAAAANNNN TTTTWWWWOOOO UUUUSSSSEEEERRRRSSSS
  141.           The current implementation of kibitz explicitly understands
  142.           only two users, however, it is nonetheless possible to have
  143.           a three (or more) -way kibitz, by kibitzing another kkkkiiiibbbbiiiittttzzzz.
  144.           For example, the following command runs kkkkiiiibbbbiiiittttzzzz with the
  145.           current user, user2, and user3:
  146.  
  147.                % kibitz user2 kibitz user3
  148.  
  149.           Additional users may be added by simply appending more
  150.           "kibitz user" commands.
  151.  
  152.           The xxxxkkkkiiiibbbbiiiittttzzzz script is similar to kkkkiiiibbbbiiiittttzzzz but supports the
  153.           ability to add additional users (and drop them) dynamically.
  154.  
  155.      CCCCAAAAVVVVEEEEAAAATTTTSSSS
  156.           kkkkiiiibbbbiiiittttzzzz assumes the 2nd user has the same terminal type and
  157.           size as the 1st user.  If this assumption is incorrect,
  158.           graphical programs may display oddly.
  159.  
  160.           kkkkiiiibbbbiiiittttzzzz handles character graphics, but cannot handle
  161.           bitmapped graphics.  Thus,
  162.  
  163.                % xterm -e kibitz    will work
  164.                % kibitz xterm       will not work
  165.  
  166.           However, you can get the effect of the latter command by
  167.           using xxxxkkkkiiiibbbbiiiittttzzzz (see SEE ALSO below).  kkkkiiiibbbbiiiittttzzzz uses the same
  168.           permissions as used by rlogin, rsh, etc.  Thus, you can only
  169.           kkkkiiiibbbbiiiittttzzzz to users at hosts for which you can rlogin.
  170.           Similarly, kkkkiiiibbbbiiiittttzzzz will prompt for a password on the remote
  171.           host if rlogin would.
  172.  
  173.           If you kkkkiiiibbbbiiiittttzzzz to users at remote hosts, kkkkiiiibbbbiiiittttzzzz needs to
  174.           distinguish your prompt from other things that may precede
  175.           it during login.  (Ideally, the end of it is preferred but
  176.           any part should suffice.) If you have an unusual prompt, set
  177.           the environment variable EXPECT_PROMPT to an egrep(1)-style
  178.           regular expression.  Brackets should be preceded with one
  179.           backslash in ranges, and three backslashes for literal
  180.           brackets.  The default prompt r.e. is "($|%|#) ".
  181.  
  182.           kkkkiiiibbbbiiiittttzzzz requires the kkkkiiiibbbbiiiittttzzzz program on both hosts.  kkkkiiiibbbbiiiittttzzzz
  183.           requires eeeexxxxppppeeeecccctttt(1).
  184.  
  185.           By comparison, the xxxxkkkkiiiibbbbiiiittttzzzz script uses the X authorization
  186.           mechanism for inter-host communication so it does not need
  187.           to login, recognize your prompt, or require kibitz on the
  188.           remote host.  It does however need permission to access the
  189.           other X servers.
  190.  
  191.      BBBBUUUUGGGGSSSS
  192.  
  193.  
  194.  
  195.      PPPPaaaaggggeeee 3333                                          ((((pppprrrriiiinnnntttteeeedddd 7777////22223333////99995555))))
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11119999 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))        KKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.           An early version of Sun's tmpfs had a bug in it that causes
  207.           kkkkiiiibbbbiiiittttzzzz to blow up.  If kkkkiiiibbbbiiiittttzzzz reports "error flushing ...:
  208.           Is a directory" ask Sun for patch #100174.
  209.  
  210.           If your Expect is not compiled with multiple-process support
  211.           (i.e., you do not have a working select or poll), you will
  212.           not be able to run kibitz.
  213.  
  214.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  215.           The environment variable SHELL is used to determine the
  216.           shell to start, if no other program is given on the command
  217.           line.
  218.  
  219.           If the environment variable EXPECT_PROMPT exists, it is
  220.           taken as a regular expression which matches the end of your
  221.           login prompt (but does not otherwise occur while logging
  222.           in). See also CAVEATS above.
  223.  
  224.           If the environment variables USER or LOGNAME are defined,
  225.           they are used to determine the current user name for a
  226.           kkkkiiiibbbbiiiittttzzzz to a remote computer. See description of the ----pppprrrrooooxxxxyyyy
  227.           option in ARGUMENTS above.
  228.  
  229.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  230.           TTTTccccllll(3), lllliiiibbbbeeeexxxxppppeeeecccctttt(3), xxxxkkkkiiiibbbbiiiittttzzzz(1)
  231.           "_E_x_p_l_o_r_i_n_g _E_x_p_e_c_t: _A _T_c_l-_B_a_s_e_d _T_o_o_l_k_i_t _f_o_r _A_u_t_o_m_a_t_i_n_g
  232.           _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s" by Don Libes, O'Reilly and Associates,
  233.           January 1995.
  234.           "_K_i_b_i_t_z - _C_o_n_n_e_c_t_i_n_g _M_u_l_t_i_p_l_e _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s
  235.           _T_o_g_e_t_h_e_r", by Don Libes, Software - Practice & Experience,
  236.           John Wiley & Sons, West Sussex, England, Vol. 23, No. 5,
  237.           May, 1993.
  238.  
  239.      AAAAUUUUTTTTHHHHOOOORRRR
  240.           Don Libes, National Institute of Standards and Technology
  241.  
  242.           kkkkiiiibbbbiiiittttzzzz is in the public domain.  NIST and I would appreciate
  243.           credit if this program or parts of it are used.
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 7/23/95)
  262.  
  263.  
  264.  
  265.